home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / C / Applications / MacTide 1.3.3 / ReadME Mac < prev    next >
Encoding:
Text File  |  1996-01-04  |  6.8 KB  |  198 lines  |  [TEXT/KAHL]
  1.     Tide  Harmonic tide clock and tide predictor
  2.     Version 1.3.3  1/4/96
  3.     Copyright (C) 1996 Mikhail Fridberg
  4.     Copyright (C) 1995  David Flater.
  5.     Also starring:  Jef Poskanzer; Jack Greenbaum; Rob Miracle;
  6.     Geoff Kuenning; Dale DePriest.
  7.  
  8.     This program is free software; you can redistribute it and/or modify
  9.     it under the terms of the GNU General Public License as published by
  10.     the Free Software Foundation; either version 2 of the License, or
  11.     (at your option) any later version.
  12.  
  13.     This program is distributed in the hope that it will be useful,
  14.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  15.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16.     GNU General Public License for more details.
  17.     
  18.     
  19.     You should have received a copy of the GNU General Public License
  20.     along with this program; if not, write to the Free Software
  21.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  22.  
  23.  
  24.     The tide prediction algorithm used in this program was developed
  25.     with United States Government funding, so no proprietary rights
  26.     can be attached to it.  For more information, refer to the
  27.     following publications:
  28.  
  29.     Manual of Harmonic Analysis and Prediction of Tides.  Special
  30.     Publication No. 98, Revised (1940) Edition.  United States
  31.     Government Printing Office, 1941.
  32.  
  33.     Computer Applications to Tides in the National Ocean Survey.
  34.     Supplement to Manual of Harmonic Analysis and Prediction of Tides
  35.     (Special Publication No. 98).  National Ocean Service, National
  36.     Oceanic and Atmospheric Administration, U.S. Department of
  37.     Commerce, January 1982.
  38.  
  39.  
  40. THIS PACKAGE IS AVAILABLE FOR ANONYMOUS FTP FROM:
  41. ftp://speckle.ncsl.nist.gov/flater/sources/mactide133.hqx 
  42. (original UNIX Tide and XTide sources)
  43. and
  44. ftp://caife.pfc.mit.edu/Pub/mactide133.hqx
  45. (My ftp-able Mac, Mac only sources and binary)
  46. (The version number may change.)
  47.  
  48. Very nice description of Harmonics analyses of tides is available 
  49. through www:
  50. http://math.math.sunysb.edu/~tony/tides/harmonic.html
  51.  
  52. I took source code for UNIX version of TTY-based Tide program, and 
  53. ported it for Mac. It is practically exact port from UNIX, so do 
  54. not expect to find any Mac-like user interface in it (at least for now).
  55.  
  56. For this program to work properly, you HAVE TO set up your 
  57. Map and Date & Time control panels! This is VERY IMPORTANT!
  58.  
  59. There are following differences between UNIX and Mac versions :
  60.  
  61.  -localtz switch is not supported, but ignored. No error generated, 
  62.    but all predictions are calculated using your local time.
  63.  
  64.  Daylight saving time is not supported. Since I don't know rules for
  65.    DST switch in your particular area, I can't predict when DST 
  66.    switch is going to happen. Another words - if tide prediction 
  67.    spawn period of time when DST switch will happen, Tide will NOT 
  68.    take that switch into account and will use same time as before the 
  69.    switch. Users beware!
  70.  
  71. None of the following switches are supported:
  72.  
  73. -fgfall color
  74. -fgmark color
  75. -fgmiddle color
  76. -fgmllw color
  77. -fgrise color
  78. -fgtext color
  79. If you use them, they will be ignored.
  80.  
  81. Tide has been tested under Mac IIsi, Mac IIsi with 68LC040 Carrera 
  82. accelerator board, PowerPC (don't remember type :)). It is NOT PowerPC 
  83. accelerated, but runs on it. It should be able to take advantage of FPU 
  84. (or 68040), if present, but I haven't tested it. All computers I run it 
  85. on were using Sys 7.5.X, but I see no reason for it not to run on any 
  86. other systems. It's should be able to run with virtual memory, but I had 
  87. not tested that either. It'll MultiFinder friendly and will work in the 
  88. background.
  89.  
  90. The source code compiles under Think C 5.0.4 I don't have Symanthec C++, 
  91. CodeWarrior or MPW, so I can't provide you with any info on porting to 
  92. those development systems.
  93.  
  94. The Think C 5.0.4 project is included. If your system can't read it, 
  95. here are the options used:
  96.  
  97. Language Settings:
  98.  
  99.  #define _STDC_
  100.  Recognize trigraphs
  101.  Check pointer types
  102.  Language extension - Think C
  103.  Strict prototype enforcement - infer prototypes
  104.  
  105. Compiler Settings:
  106.  
  107.  4-byte ints
  108.  8-byte doubles
  109.  
  110. Code Optimization:
  111.  
  112.  everything on
  113.  
  114. Prefix:
  115.  
  116.  #include <MacHeaders>
  117.  
  118. Set Project Type:
  119.  
  120.  Far CODE
  121.  Far DATA
  122.  Size Flags - 5880 (MultiFinder Aware, Background Null Events, 
  123.     Suspend & Resume Events, 32-bit compatible)
  124.  Partition - 400K
  125.  
  126. Files in the project:
  127.  
  128. Segment 1:
  129.   arglib.c
  130.   tide.c
  131.   tidelib.c
  132. Segment 2:
  133.  ANSI-bytes
  134. Segment 3:
  135.  MacTraps
  136.  
  137.  
  138. ANSI-4bytes is ANSI library that come with Think C 5.0.4, recompiled 
  139. with same options as this project (including Far CODE and Far DATA 
  140. options). I do not include it with this distribution, since it's a 
  141. commercial, copyrighted product of Symanthec. If you want to profile 
  142. Tide by including profiler library, you HAVE TO recompile it 
  143. (profiler, that is) the same way as ANSI library.
  144.  
  145. All headers necessary to compile Tide are included, with exception to 
  146. the ones that are part of Think C 5.0.4 development system.
  147.  
  148. For people unfamiliar with Think C command argument styles:
  149. When run, Tide will present you with dialog box, in which you just 
  150. need to type in switches, as explained in separate README file. Do 
  151. not delete word "tide" that you'll see in the dialog box. The radio 
  152. buttons on the left will allow you to select where your output is 
  153. going to go - screen, screen and file, or screen and printer.
  154.  
  155. I apologize in advance for ugliness of this approach, but I don't 
  156. really have time for writing nice Mac-like GUI. Besides, I'm hoping 
  157. that someone with more time, and maybe, PowerPC, can take over and 
  158. write an application that will make people from any other platform 
  159. drool :).
  160.  
  161. Note that this Mac version is port of TTY variant of tide 1.3.3, 
  162. not XTide 1.3.3
  163.  
  164. The description of tide 1.3.3, it's usage and list of switches given 
  165. in separate README file, which should be part of this distribution.
  166.  
  167.  
  168.     I would also like to add that I will not be responsible for ANY damages 
  169.     arising from the use of this program, included, but not limited to, 
  170.     loss of property, loss of life and damages to others. Another words, 
  171.     if you use it, run aground as a result and lose your boat, it's your 
  172.     own problem. I would also point out that no single navigational aid 
  173.     should be used without exercising caution and common sense. I had 
  174.     spot-checked this program using Eldridge Tide and Pilot Book for 1996, 
  175.     for Boston Harbor. The results were very much the same, and I won't be 
  176.     surprised if it uses same UNIX program for tide calculations. Nevertheless, 
  177.     I recommend to check and double check the results of this program with 
  178.     your own observations, almanacs, etc. You have been warned.
  179.  
  180.  
  181. Contact Info
  182. ------------
  183.  
  184. Mikhail Fridberg
  185. e-mail - fridberg@pfc.mit.edu 
  186.  
  187.  
  188. Bugs
  189. ----
  190.  
  191. No known Mac-specific bugs (yet). The bugs listed in README apply to this 
  192. version as well.
  193.  
  194. Acknowledgements
  195. ----------------
  196.  
  197. Thanks to David Flater for writing tide for UNIX under GNU license.
  198.